home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / yestrdy6.zip / YESTRDAY.DOC < prev    next >
Text File  |  1992-01-18  |  12KB  |  304 lines
  1.                           EagleSoft presents.....
  2.  
  3.    YESTERDAY ---- Log scanners for Wildcat! BBS ver. 3.0 ---- TODAYCALL
  4.    --------------------------------------------------------------------
  5.    Version 4.0               January 1992                   Version 4.0
  6.  
  7. What it is:
  8. -----------
  9. Many SysOps like to show their callers the activity on their BBSs.  Some
  10. like a cumulative log for the current day, which requires a "call pro-
  11. cessing event" after each call.  TODAYCALL will handle this for you.
  12. Put it in a POSTCALL.RUN file and it will refresh the bulletin after each
  13. call.  Some prefer to scan their logs once a night and prepare a list of
  14. the previous day's activity.  This is what YESTRDAY & YESTRDYM do for you.
  15. They are intended to run as soon as possible after midnight, but can be
  16. run anytime during the day.  YESTRDYM is a multi-line version of YESTRDAY.
  17. It requires more system resources and takes longer to run, so use YESTRDAY
  18. for single line systems.  All three programs reduce the information in the
  19. log to a single line for each call, showing Name, City, Baud, Messages
  20. Posted, Uploads, Downloads, Time On, Time Off and whether the caller dropped
  21. carrier.  At the end of the run it will summarize all of this, plus total
  22. number of calls, local log-ins, minutes used, and in the case of YESTERDAY,
  23. utilization percentage.  YESTERDAY allows you to specify the average number
  24. of minutes per day your BBS is available for calls, i.e. excluding events
  25. and other scheduled off-line time.  If your events total 40 minutes per day,
  26. your utilization will be calculated based upon 1400 available minutes rather
  27. than 1440.  If you run a part-time board that's only on-line 12 hours a day,
  28. your usage will be calculated based on 720 minutes.  A file with the name of
  29. your choice is written and can be used for a bulletin, a hello screen or
  30. however you choose.
  31.  
  32. What it costs:
  33. --------------
  34. NOTHING!  The executables of YESTERDAY and TODAYCALL are freeware.  No cost.
  35. Running a bulletin board is expensive enough without one more clown sticking
  36. his hand out.  Run them on your board, give them to your friends, make them
  37. available for downloading.  In short, ENJOY!   (Of course, if you like them
  38. enough and want to express your appreciation in some tangible form, it would
  39. always be welcome.  Like I said, running a BBS is expensive!)
  40.  
  41. All rights to the source code for YESTERDAY and TODAYCALL remain with the
  42. author, Norman Morgan.
  43.  
  44. You may NOT modify these programs or supporting files, including this
  45. documentation, in any way.  Although I have written and tested the programs
  46. carefully, and they appears to function without error, you assume all risks
  47. associated with their use.  I will not be responsible for any damages caused
  48. by the use of this program.
  49.  
  50. What's New in 4.0?
  51. ------------------
  52. All three programs now support only Wildcat! 3.0 formats.  Bulletins are
  53. generated using the "@BF@" codes for color and the "@PAUSE@" at the end of
  54. each bulletin.
  55.  
  56. The Program does NOT handle the new filename format for the activity log.
  57. You must copy or rename your log file to ACTIVITY.LOG before running these
  58. programs.
  59.  
  60. YESTRDAY.DOC                                                           Page 1
  61.  
  62.                     YESTERDAY Wildcat! Log Scan...cont'd.
  63.                     -------------------------------------
  64. How it works:
  65. -------------
  66. YESTERDAY checks the system date and calculates yesterday's date from it.
  67. The algorithm used is correct through 2003.  It then reads the log file
  68. and examines each line to determine if it is a logon record, a logoff
  69. record, a line of dashes, or something else.  Information is extracted
  70. from the various records and used to accumulate the statistics.  Names and
  71. cities are truncated to 22 characters if they are longer.  Selected records
  72. which match on date are written to the bulletin files.  Both a regular and
  73. ANSI color file are created.
  74.  
  75. While it is running, YESTERDAY keeps you informed as to what it is doing.
  76. When it is skipping records from earlier dates, it scrolls the dashed line
  77. separators.  When it is processing yesterday's calls, it scrolls each log
  78. record in a center window.  Each detail line written to the output file is
  79. display in a bottom window.
  80.  
  81. How YESTRDAY is run:
  82. --------------------
  83. Place YESTRDAY.EXE in the directory where your ACTIVITY.LOG is located.
  84. Run YESTRDAY with a command line parameter naming the file you wish to
  85. create:
  86.  
  87.     YESTRDAY \wildcat\bull\bull12 /1380
  88.  
  89. NOTE:  YESTERDAY will automatically add the .BBS extension for your file.
  90.  
  91. The "/1380" indicates that this BBS is off-line for events or other reasons
  92. for an average 60 minutes per day.  If this parameter is omitted, YESTERDAY
  93. assumes a full 24 hour availability and uses 1440 minutes in the utilization
  94. calculations.  The "/" and the space before it are mandatory if the parameter
  95. is used.  Note that this parameter is always in minutes and can never exceed
  96. 1440.  A part-time board on-line for 12 hours would enter /720.
  97.  
  98. That's all there is to it.  On small log files it runs less than 30 seconds.
  99. I purge my log every night after running YESTERDAY and Mustang's S-PRO!, but
  100. if you wish to leave longer log files intact or choose not to run YESTERDAY
  101. at exactly midnight, it will happily extract just the previous days' activity
  102. whenever it is run.
  103.  
  104. YESTRDYM is run identically to its little brother with two exceptions.  You
  105. must first concatenate all your node activity logs into a single file with
  106. the DOS concatenation operator.  Like this...
  107.  
  108. COPY ACTIVITY.001+ACTIVITY.002+ACTIVITY.003 ACTIVITY.LOG
  109.  
  110. The resulting file MUST be named ACTIVITY.LOG.  It does not matter where you
  111. put this resulting file so long as it is in the current DOS directory.  The
  112. other difference between YESTRDYM and YESTRDAY is the time parameter.  Add up
  113. the average available minutes for all nodes combined and place that number in
  114. the command line.
  115.  
  116. YESTRDYM can handle an absolute maximum of 500 calls for all nodes combined.
  117. This limitation is due to the sorting that must occur to keep the output
  118. files in ascending time order.  If you require a version that can handle
  119. more than 500 total calls per day, please contact me.
  120.  
  121. YESTRDAY.DOC                                                           Page 2
  122.  
  123.                     TODAYCALL Wildcat! Log Scan...cont'd.
  124.                     -------------------------------------
  125. How it works:
  126. -------------
  127. TODAYCALL extracts the system date and compares it to each date in the log.
  128. It examines each line to determine if it is a logon record, a logoff
  129. record, a line of dashes, or something else.  Information is extracted
  130. from the various records and used to accumulate the statistics.  Names and
  131. cities are truncated to 22 characters if they are longer.  Selected records
  132. which match on date are written to the bulletin files.  Both a regular and
  133. ANSI color file are created.
  134.  
  135. While it is running, TODAYCALL keeps you informed as to what it is doing.
  136. When it is skipping records from earlier dates, it scrolls the dashed line
  137. separators.  When it is processing today's calls, it scrolls each log
  138. record in a center window.  Each detail line written to the output file is
  139. display in a bottom window.
  140.  
  141. How it is run:
  142. --------------
  143. Place TODAYCAL.EXE in the directory where your ACTIVITY.LOG is located.
  144. Run TODAYCAL with a command line parameter naming the file you wish to
  145. create:
  146.  
  147.     TODAYCAL \wildcat\bull\bull13
  148.  
  149. NOTE:  Do not specify an extension on the file name.  TODAYCALL will
  150. automatically add the .BBS extension for your file.
  151.  
  152. The easiest way to run it is to modify your CAT.BAT file to run a "Call
  153. Processing Event".  See pages 151 and 214 in your Wildcat! 3.0 manual for
  154. full details on using the POSTCALL.RUN file.  Unless you keep enormous
  155. amounts of old data in your activity log, it should add only 15-20 seconds
  156. to the time between calls.  TODAYCALL remains a single node program.  It
  157. did not seem reasonable to be reading another node's activity log if that
  158. node might be writing to it!
  159.  
  160. Each of the preceding program works much faster with small log files.
  161. Balancing the need to keep historical log information and the need to keep
  162. logs as compact as possible, we present the final program in this set:
  163.  
  164. SAVELOG.EXE
  165. -----------
  166.  
  167. My personal strategy for log-keeping is to have no more than one (1) days
  168. data in the ACTIVITY.nnn file.  I run a soft event as soon as possible
  169. after midnight and process the log information, then reset the log for a
  170. new day.  Here is am extract from that event...
  171.  
  172.    .....
  173.    COPY ACTIVITY.001 ACTIVITY.LOG
  174.    YESTRDAY \WC30\BULL\BULL11 /1320
  175.    SAVELOG C:\BACKUP\
  176.    DEL ACTIVITY.LOG
  177.    WCPRO NIGHTLY.PRO
  178.    .....
  179.  
  180.  
  181.  
  182. YESTRDAY.DOC                                                           Page 3
  183.  
  184.                    SAVELOG Wildcat! Log Manager...cont'd.
  185.                    --------------------------------------
  186. How it works:
  187. -------------
  188.  
  189. SAVELOG copies ACTIVITY.LOG to a new file named YYMMDD.LOG, where YYMMDD is
  190. the yesterday's date.  It then appends this new file to a ZIP file called
  191. xxxLOGS.ZIP, where xxx is JAN, FEB, MAR, etc.  The ZIP file will be located
  192. in the path named on the command line.
  193.  
  194. Want to find any day's log?  Fire up SHEZ or ARCMASTER in that directory and
  195. your have a completely indexed collection of logs for an entire year!
  196.  
  197. Now it is safe to either let WCPRO scratch your ACTIVITY.nnn or you may do
  198. as part of your event if you do not use WCPRO.
  199.  
  200.  
  201. Credits and Copyrights:
  202. -----------------------
  203. YESTERDAY, YESTERDAYM, TODAYCALL and SAVELOG are copyright 1992 by
  204. Norman Morgan.  They are written in Microsoft QuickBASIC and incorporate
  205. the excellent user interface routines written by Daniel R. Berry and
  206. Traveler Software.  They are compiled to be stand-alone programs and do
  207. NOT require the QB runtime module to operate.
  208.  
  209.  
  210.  
  211.      Support for this and other EagleSoft programs is available on
  212.     The Eagle's Nest BBS -- dedicated to supporting the principles,
  213.          programs and members of the Boy Scouts of America.
  214.  
  215.                        Norman Morgan - SysOp
  216.                   <<<<< The Eagle's Nest BBS >>>>>
  217.         (812) 425-6950  24 hrs  8/N/1  300/1200/2400/9600HST
  218.                         RelayNet ID:  SCOUT
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243. YESTRDAY.DOC                                                           Page 4
  244.  
  245.  
  246.  
  247.                   R E G I S T R A T I O N   F O R M
  248.                   ---------------------------------
  249.                    YESTERDAY 4.0 -*- TODAYCALL 4.0
  250.  
  251.  
  252. There is NO CHARGE for using YESTERDAY or TODAYCALL, but we would like to
  253. know who you are and to hear any suggestions you might have for improving
  254. the programs.  Please tear off this page, fill it in and mail it to the
  255. address below:
  256.  
  257.  
  258. Please print:
  259.  
  260.  
  261.         BBS Name:__________________________________________
  262.  
  263.       BBS Number:__________________________________________
  264.  
  265.        BBS Hours:__________________________________________
  266.  
  267.       Baud Rates:__________________________________________
  268.  
  269.        Your Name:__________________________________________
  270.  
  271.          Address:__________________________________________
  272.  
  273.                  __________________________________________
  274.  
  275.             City:_____________________________  State: ____
  276.  
  277.         ZIP Code:_______________   Phone:__________________
  278.  
  279.  
  280.  
  281. Please mail this form to:
  282.  
  283.  
  284.                           Norman O. Morgan
  285.                           313 Lexington Road
  286.                           Evansville, IN  47710-3724
  287.  
  288.  
  289. Comments and suggestions:
  290.  
  291. ____________________________________________________________________________
  292.  
  293. ____________________________________________________________________________
  294.  
  295. ____________________________________________________________________________
  296.  
  297. ____________________________________________________________________________
  298.  
  299. ____________________________________________________________________________
  300.  
  301. ____________________________________________________________________________
  302.  
  303. ____________________________________________________________________________
  304.